package com.mall.module.system.mapper;

import com.mall.module.system.domain.dto.UserQueryDto;
import com.mall.module.system.domain.entity.SysUser;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;

import java.util.List;

/**
 * 系统用户数据访问层
 */
@Mapper
public interface SysUserMapper {
    
    /**
     * 检查用户名是否存在
     * @param username 用户名
     * @return 是否存在
     */
    boolean existsByUsername(@Param("username") String username);

    /**
     * 检查邮箱是否存在
     * @param email 邮箱
     * @return 是否存在
     */
    boolean existsByEmail(@Param("email") String email);
    
    /**
     * 检查手机号是否存在
     * @param mobile 手机号
     * @return 是否存在
     */
    boolean existsByMobile(@Param("mobile") String mobile);

    /**
     * 插入用户
     * @param user 用户信息
     */
    void insert(SysUser user);

    /**
     * 根据用户名查询用户
     * @param username 用户名
     * @return 用户信息
     */
    SysUser selectByUsername(@Param("username") String username);
    
    /**
     * 根据ID查询用户
     * @param id 用户ID
     * @return 用户信息
     */
    SysUser getUserById(@Param("id") Long id);

    /**
     * 更新登录时间
     * @param id 用户ID
     */
    void updateLoginTime(@Param("id") Long id);
    
    /**
     * 增加登录次数
     * @param id 用户ID
     */
    void incrementLoginCount(@Param("id") Long id);
    
    /**
     * 更新最后登出时间
     * @param id 用户ID
     */
    void updateLastLogoutTime(@Param("id") Long id);
    
    /**
     * 更新用户登录信息
     * @param id 用户ID
     * @param loginIp 登录IP
     */
    void updateLoginInfo(@Param("id") Long id, @Param("loginIp") String loginIp);

    /**
     * 分页查询用户列表
     * @param pageNum 页码
     * @param pageSize 页大小
     * @return 用户列表
     */
    List<SysUser> list(@Param("pageNum") Integer pageNum, @Param("pageSize") Integer pageSize, @Param("queryDto") UserQueryDto queryDto);

    /**
     * 根据ID更新用户信息
     * @param user 用户信息
     */
    void updateById(SysUser user);
    
    /**
     * 逻辑删除用户
     * @param id 用户ID
     */
    void deleteById(@Param("id") Long id);
    
    /**
     * 根据条件查询用户列表
     * @param user 查询条件
     * @return 用户列表
     */
    List<SysUser> selectByCondition(SysUser user);
    
    /**
     * 根据部门ID查询用户列表
     * @param deptId 部门ID
     * @return 用户列表
     */
    List<SysUser> selectByDeptId(@Param("deptId") Long deptId);
    
    /**
     * 批量查询用户
     * @param ids 用户ID列表
     * @return 用户列表
     */
    List<SysUser> selectByIds(@Param("ids") List<Long> ids);
    
    /**
     * 统计用户数量
     * @param user 查询条件
     * @return 用户数量
     */
    long countUsers(SysUser user);
    
    /**
     * 更新用户状态
     * @param id 用户ID
     * @param status 状态
     * @param updaterId 更新人ID
     */
    void updateStatus(@Param("id") Long id, @Param("status") Integer status, @Param("updaterId") Long updaterId);
    
    /**
     * 更新用户密码
     * @param id 用户ID
     * @param newPassword 新密码
     * @param updaterId 更新人ID
     */
    void updatePassword(@Param("id") Long id, @Param("newPassword") String newPassword, @Param("updaterId") Long updaterId);
    
    /**
     * 批量逻辑删除用户
     * @param ids 用户ID列表
     * @param updaterId 更新人ID
     */
    void batchDelete(@Param("ids") List<Long> ids, @Param("updaterId") Long updaterId);
}
